home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / prgtools / sdnkit12.zip / SDNID.TXT < prev    next >
Text File  |  1996-04-27  |  9KB  |  218 lines
  1.  
  2.  
  3.  
  4.  
  5.                                                 SDN INTERNATIONAL(sm)
  6.                                        Shareware Distribution Network
  7.  
  8.  
  9.  
  10.  
  11.                                   Shareware Author Kit - Revision #12
  12.                                            Guide To The SDN.ID Format
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                     Published from The SDN Project, January 28th 1996
  19.                     (c)Copyright 1996 Ray L. Kaliss - The SDN Project
  20.  
  21.  
  22.  
  23.                          -= Copyright Notice =-
  24.  
  25.      This document is Copyright The SDN Project 1996 and the property
  26.      of Ray  L.  Kaliss  as The  SDN Project.   This document  in not
  27.      public domain.  It is intended  as an informational document for
  28.      Shareware   authors   submitting  for   distribution   via   SDN
  29.      International.  This document may be copied whole and unmodified
  30.      for  that intent  only.  Official  Policy is  formulated by  SDN
  31.      International and published at The SDN Project Bulletin Board in
  32.      Meriden, CT, U.S.A.  203-634-0370. Policy and information posted
  33.      online at The SDN Project supersedes policy in circulation or of
  34.      earlier date.
  35.  
  36.      SDN, The SDN Project, and the  service mark of SDN International
  37.      are Copyright  1989-1996 by Ray L.   Kaliss and can not  be used
  38.      with out express  written permission.  Files distributed  by SDN
  39.      are  copyright by  their  respective  authors.  SDN's  packaging
  40.      format   and  SDN.ID   individually  are   copyrighted  by   SDN
  41.      International.
  42.  
  43.  
  44.  
  45. THE SDN.ID FORMAT EXPLAINATION
  46. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47.      To process  and distribute on such  a scale..  we  are partially
  48.      automated.  What  assists us is an  ASCII text file we  call the
  49.      SDN.ID file.   It also lets  downloaders know that  the software
  50.      meets  SDN's crieria,  has been  virus scanned  and is  security
  51.      sealed.  The format is copyright to SDN.  You create it yourself
  52.      with any  ASCII editor,  it is  really quite  simple.  You  must
  53.      include one for each program you submit to us.
  54.  
  55.      The SDN.ID is pure ASCII text (no hidden control codes) and is a
  56.      format  of which  the first  three  lines serve  double duty  as
  57.      readable description  and processing control  information.  Here
  58.      is what the first few lines  look like and their explanations of
  59.      purpose.  For further  example examine the SDN.ID  included with
  60.      this kit.
  61.  
  62.         (Spacing may not be lined up if you print this example)
  63.  
  64.    ┌────────────────────────────────────────────────────────────────┐
  65.    │X-Word Editor 2.1 fast editor for the novice and experienced    │
  66.    │WIN95 EDITOR WRITE PROCESSOR SPELL BLANCE                       │
  67.    │FILES: xword21.zip                                              │
  68.    │                                                                │
  69.    │Author: Timothy Blance                                          │
  70.    │Registration: $50.00                                            │
  71.    │Category: Word Processing                                       │
  72.    │E-mail: tblance@netthing.com                                    │
  73.    │                                                                │
  74.    │   A superVGA editor system that uses icons you create.         │
  75.    │Fantastic for the novice or the advanced power user. Spell      │
  76.    │checker is included. Has a preview mode and will use five       │
  77.    │etc.. etc..  etc..
  78.    │
  79.  
  80.  
  81.      DESCRIPTION LINE
  82.      ~~~~~~~~~~~~~~~~
  83.      The  first line,  begins  with the  name  of  your program,  the
  84.      version number, and a few words of description.  Keep this to 80
  85.      characters or less.  There is no  need to use the word "Version"
  86.      or "v" (v.2.1), downloaders already know or learn very fast what
  87.      a version number is, it simply wastes space.
  88.  
  89.  
  90.      KEYWORD LINE
  91.      ~~~~~~~~~~~~
  92.      The very first keyword, left  justified, is the operating system
  93.      this program runs under.  Other appropriate keywords can follow.
  94.      Keep in mind  one commercial service limits the  keyword line to
  95.      less than  70 characters  and I  may truncate  to fit.   Use all
  96.      capitals.   Do not  use the  keyword "SHAREWARE",  if it  wasn't
  97.      shareware,  it  wouldn't  be here.   Standard  operating  system
  98.      keywords are given  below.  Use only one,  the primary operating
  99.      system your program  is coded to run under.   On online services
  100.      your program will be delivered to this primary forum.
  101.  
  102.               DOS      WIN31     WIN95     WINNT      OS/2
  103.  
  104.      FILES LINE
  105.      ~~~~~~~~~~
  106.      On  this line  give  the  file name  you  would  like the  final
  107.      downloadable   compressed  archive   to  be   named.   SDN   has
  108.      standardized on Zip compression for  archiving, so the extension
  109.      will always  be ".zip".  Use all  lower case for this  name, the
  110.      Internet   prefers   lower   case   named   files.    Use   only
  111.      alpha-numerical characters, do not use a number or non-alpha for
  112.      the first  letter of the  file name,  some sites can  not accept
  113.      that.   Bulletin  board  convention  is   to  use  a  few  alpha
  114.      characters  and then  the version  number for  the posting  file
  115.      name.  This keeps it unique, which  is important.  It also helps
  116.      the downloader recognize  your latest version from  your earlier
  117.      versions.  (See  Appendices for  more information  on file  name
  118.      conventions).
  119.  
  120.      SDN reserves the right to edit the final archive file name so it
  121.      is compatible with online systems and to prevent conflicts which
  122.      may hinder it from being distributed or posted.
  123.  
  124.  
  125.      AUTHOR LINE
  126.      ~~~~~~~~~~~
  127.      Put in  your proud name  as author, or  if you are  a publishing
  128.      company given the  authority to distribute the  software for the
  129.      author, change the line to "Publisher:" and then put the company
  130.      name.
  131.  
  132.  
  133.      REGISTRATION  LINE
  134.      ~~~~~~~~~~~~~~~~~~
  135.      Put your  registration fee here.   There is  no need to  get too
  136.      detailes, users should read your  programs documentation for the
  137.      full registration details.
  138.  
  139.  
  140.      CATEGORY LINE
  141.      ~~~~~~~~~~~~~
  142.      There  are no  universal  category standards  in  common in  the
  143.      online community,  so come up  with a  one or two  word category
  144.      that simnply describes your software.   If you are familiar with
  145.      the ASP categories you should use one.
  146.  
  147.  
  148.      EMAIL LINE
  149.      ~~~~~~~~~~
  150.      If you have an Internet address and do not mind email, then give
  151.      it here.  This line  is optional, you can simply skip  it if you
  152.      want to.   Many times  I have been  contacted by  companies that
  153.      wish to offer the author a publishing deal, they can contact you
  154.      directly  now.   On  the  other hand,  you  may  get  plenty  of
  155.      chit-chat mail taking up your time.
  156.  
  157.  
  158.      DESCRIPTION BODY
  159.      ~~~~~~~~~~~~~~~~
  160.      Here is the main description of your program.  Keep it short and
  161.      to the point of your main features.  Unlike the top header lines
  162.      which must all be left justified, the body lines can be indented
  163.      for better visual effect.  About two screens of description text
  164.      is all  a user reading  it online can  absorb.
  165.  
  166.  
  167.      REQUIREMENTS LINE
  168.      ~~~~~~~~~~~~~~~~~
  169.      This line  is optional.  Many  authors put a  Requirements: line
  170.      after the description  body.  This might tell users  they need a
  171.      SVGA, modem  or other non-basic  hardware, or other  software to
  172.      work with the program.
  173.  
  174.  
  175.  
  176.  
  177.  
  178.      MAILED IN DISK SUBMISSIONS
  179.      ~~~~~~~~~~~~~~~~~~~~~~~~~~
  180.      Name and save the file as SDN.ID and copy it onto the first disk
  181.      of your program you will be sending us.
  182.  
  183.      Example directory of your disk:
  184.  
  185.                    MENU    EXE    345266  12-10-93   1:03p
  186.                    MENU    DOC     16354  12-10-93  10:10a
  187.                    MENU    DAT      4562  10-12-93  11:01a
  188.              ->    SDN     ID       1500  12-11-93   2:25p
  189.                    SORT    EXE     34555  12-11-93   4:00p
  190.  
  191.  
  192.  
  193.  
  194.      SDNMAKER SUBMISSIONS
  195.      ~~~~~~~~~~~~~~~~~~~~
  196.      Copy the SDN.ID  to the SOURCE diretory with  your program files
  197.      so SDNMaker can find it.
  198.  
  199.  
  200.  
  201. LAST WORDS
  202. ~~~~~~~~~~
  203.      SDN  reserves  the  right  to edit  the  SDN.ID  to  better  fit
  204.      processing needs before  your program is distributed.   Be aware
  205.      SDN.ID is included in the final compressed package.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217. /eof
  218.